home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 November: Tool Chest / Dev.CD Nov 00 TC Disk 1.toast / Sample Code / Networking / TransferProvider / Read Me About TransferProvider < prev    next >
Encoding:
Text File  |  2000-09-28  |  3.0 KB  |  58 lines  |  [TEXT/ttxt]
  1. Read Me About TransferProvider
  2.  
  3. 1.0d1
  4.  
  5. This sample demonstrates how to use OTTransferProviderOwnership to transfer the ownership of an Open Transport provider (eg an endpoint) between Open Transport clients.  In this example, an endpoint is transferred between a shared library and an application that calls that shared library.  The code from this sample is featured in the latest release (v1.2) of the book “Inside Macintosh: Open Transport”.
  6.  
  7. Packing List
  8.  
  9. The package contains the following items items: 
  10.  
  11. • TransferProvider-PPC.µ — A project to build the PPC version. 
  12. • TransferProvider — A compiled version of the above.
  13.  
  14. • TransferProvider.c — Source code for the application.
  15.  
  16. • ProviderFactory-PPC.µ — A shared library that creates endpoints for the application.
  17. • ProviderFactory-PPC.µ.exp — An export file for the above.
  18. • ProviderFactory — A compiled version of the above.
  19.  
  20. • ProviderFactory.h — Interface to the provider factory shared library.
  21. • ProviderFactory.c — Source code for the provider factory shared library.
  22.  
  23. Sample Requirements
  24.  
  25. I tested this code with OT 1.2 running under Mac OS 8 on PPC.  The code should run just fine with OT 1.1.1 or newer.  I do not support this code on OT versions prior to 1.1.1.
  26.  
  27. The technique illustrated by this sample works just fine on 68K (using a CFM-68K shared library, an ASLM shared library, or a 68K code resource), but it was much easier to build and test using CFM-PPC.
  28.  
  29. Theory of Operation
  30.  
  31. The sample contains two projects.  The first, “ProviderFactory-PPC.µ”, builds a shared library, “ProviderFactory”, that contains three exported routines.  Two of the routines are initialisation and termination routines, the third will create an endpoint on behalf of the client calling the library.
  32.  
  33. The second project, “TransferProvider-PPC.µ”, is an application that acts as a client of the above shared library.  When you run the application, it initialises the “ProviderFactory” library and then calls it to create an endpoint.  It then uses OTTransferProviderOwnership to inform OT that the endpoint is now owned by the application, not the shared library.
  34.  
  35. Running the Sample
  36.  
  37. To run the sample, simply double click the application and read the output on the console window.
  38.  
  39. Building the Sample
  40.  
  41. The sample was built using the Metrowerks CodeWarrior 11 environment and the Open Transport 1.1.1 SDK interfaces and libraries.
  42.  
  43. To rebuild the sample, first open each project and change the “LatestInterfaces” and “LatestLibraries” access paths to point to the interfaces and libraries from the OT 1.1.1 (or newer) SDK.  Then choose Make from the Project menu.  Because ProviderFactory is a shared library, it does not matter which order you build the two projects in.
  44.  
  45. Credits and Version History
  46.  
  47. If you find any problems with this sample, mail <DevSupport@apple.com> with “Attn: Quinn” as the first line of your mail and I’ll try to fix them up.
  48.  
  49. Version 1.0d1 is the first release.
  50.  
  51. Share and Enjoy
  52.  
  53. Quinn “The Eskimo!”
  54. Apple Developer Technical Support
  55. Networking, Communications, Hardware
  56.  
  57. 2 Sep 1997
  58.